home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1998 June / SGI Freeware 1998 June.iso / dist / fw_fileutils.idb / usr / freeware / catman / u_man / cat1 / chmod.Z / chmod
Text File  |  1998-05-21  |  5KB  |  134 lines
  1. /xlv1/freeware/1998.May/fileutils/3.16/fileutils-3.16.diffbuild/man
  2.  
  3.  
  4.  
  5.      CCCCHHHHMMMMOOOODDDD((((1111))))         FFFFSSSSFFFF ((((GGGGNNNNUUUU FFFFiiiilllleeee UUUUttttiiiilllliiiittttiiiieeeessss))))          CCCCHHHHMMMMOOOODDDD((((1111))))
  6.  
  7.  
  8.  
  9.      NNNNAAAAMMMMEEEE
  10.       chmod    - change the access permissions    of files
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       cccchhhhmmmmoooodddd    [-Rcfv]    [--recursive] [--changes] [--silent] [--quiet]
  14.       [--verbose] [--help] [--version] mode    file...
  15.  
  16.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.       This documentation is    no longer being    maintained and may be
  18.       inaccurate or    incomplete.  The Texinfo documentation is now
  19.       the authoritative source.
  20.  
  21.       This manual page documents the GNU version of    cccchhhhmmmmoooodddd.    cccchhhhmmmmoooodddd
  22.       changes the permissions of each given    file according to
  23.       _m_o_d_e,    which can be either a symbolic representation of
  24.       changes to make, or an octal number representing the bit
  25.       pattern for the new permissions.
  26.  
  27.       The format of    a symbolic mode    is `[ugoa...][[+-
  28.       =][rwxXstugo...]...][,...]'.    Multiple symbolic operations
  29.       can be given,    separated by commas.
  30.  
  31.       A combination    of the letters `ugoa' controls which users'
  32.       access to the    file will be changed: the user who owns    it
  33.       (u), other users in the file's group (g), other users    not in
  34.       the file's group (o),    or all users (a).  If none of these
  35.       are given, the effect    is as if `a' were given, but bits that
  36.       are set in the umask are not affected.
  37.  
  38.       The operator `+' causes the permissions selected to be added
  39.       to the existing permissions of each file; `-'    causes them to
  40.       be removed; and `=' causes them to be    the only permissions
  41.       that the file    has.
  42.  
  43.       The letters `rwxXstugo' select the new permissions for the
  44.       affected users: read (r), write (w), execute (or access for
  45.       directories) (x), execute only if the    file is    a directory or
  46.       already has execute permission for some user (X), set    user
  47.       or group ID on execution (s),    save program text on swap
  48.       device (t), the permissions that the user who    owns the file
  49.       currently has    for it (u), the    permissions that other users
  50.       in the file's    group have for it (g), and the permissions
  51.       that other users not in the file's group have    for it (o).
  52.  
  53.       A numeric mode is from one to    four octal digits (0-7),
  54.       derived by adding up the bits    with values 4, 2, and 1.  Any
  55.       omitted digits are assumed to    be leading zeros.  The first
  56.       digit    selects    the set    user ID    (4) and    set group ID (2) and
  57.       save text image (1) attributes.  The second digit selects
  58.       permissions for the user who owns the    file: read (4),    write
  59.       (2), and execute (1);    the third selects permissions for
  60.       other    users in the file's group, with    the same values; and
  61.  
  62.  
  63.  
  64.      Page 1                         (printed 5/18/98)
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.      CCCCHHHHMMMMOOOODDDD((((1111))))         FFFFSSSSFFFF ((((GGGGNNNNUUUU FFFFiiiilllleeee UUUUttttiiiilllliiiittttiiiieeeessss))))          CCCCHHHHMMMMOOOODDDD((((1111))))
  72.  
  73.  
  74.  
  75.       the fourth for other users not in the    file's group, with the
  76.       same values.
  77.  
  78.       cccchhhhmmmmoooodddd    never changes the permissions of symbolic links; the
  79.       cccchhhhmmmmoooodddd    system call cannot change their    permissions.  This is
  80.       not a    problem    since the permissions of symbolic links    are
  81.       never    used.  However,    for each symbolic link listed on the
  82.       command line,    cccchhhhmmmmoooodddd changes the permissions of the pointed-
  83.       to file.  In contrast, cccchhhhmmmmoooodddd ignores symbolic    links
  84.       encountered during recursive directory traversals.
  85.  
  86.     OOOOPPPPTTTTIIIIOOOONNNNSSSS
  87.       -_c, --_c_h_a_n_g_e_s
  88.            Verbosely describe only files whose permissions
  89.            actually    change.
  90.  
  91.       -_f, --_s_i_l_e_n_t,    --_q_u_i_e_t
  92.            Do not print error messages about files whose
  93.            permissions cannot be changed.
  94.  
  95.       -_v, --_v_e_r_b_o_s_e
  96.            Verbosely describe changed permissions.
  97.  
  98.       -_R, --_r_e_c_u_r_s_i_v_e
  99.            Recursively change permissions of directories and their
  100.            contents.
  101.  
  102.       --_h_e_l_p
  103.            Print a usage message on    standard output    and exit
  104.            successfully.
  105.  
  106.       --_v_e_r_s_i_o_n
  107.            Print version information on standard output then exit
  108.            successfully.
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.      Page 2                         (printed 5/18/98)
  131.  
  132.  
  133.  
  134.